|
Support Engineering Group : OASIS Moorings
This page last changed on Dec 01, 2010 by kgomes.
Something from an email from Rich: I ran some tests yesterday... 1) I STRONGLY recommend looking at your cfg file in a hex editor before attempting to upload it to make sure that it has a cr lf line terminators. That is hex 0D 0A You may have multiple pairs between lines but you must at least have the 0A It wont look right in notepad of you are missing the pair, and it wont work when gets on the controller in certain send scenarios, so don't do it if its not right!! Some text editors - like ones that ask 'Do you want to convert to DOS' or something similar may cause a problem - but xfering w/hyperterm definitely can cause problems regardless of the editor you use depending on your coms settings. If the file 'looks right' in notepad, that's a good sign but still - look in a hex editor!! XVI32 works quite well and is freeware http://www.chmaas.handshake.de/delphi/freeware/xvi32/xvi32.htm OK, here is what I found.... 2) ABSOLUTELY::: upload to a temporary file on the controller ** NOT TO OASIS.CFG !!! ****. They type it back to see that its not "all on one line" then its probably safe to rename it to oasis.cfg and reboot. 3) It makes a big difference to hyperterm if you are at the OASIS> prompt or in picodos... 4) Craig etal suggest going from picodos with a yr command, but I don't like to because if you forget your connected via radio you may be SOL for 30 minutes because you'll probably kill the radio driver and have to wait for 32 minutes for the hardware to rest(I have not tested that, Im trying at my desk right now...). 5) I prefer to use "capture" command and motocross but you need a version that has the "Transfer>SendBinaryFile" menu item. (eg. v2.32 has it, an older version that Paul found out at sea did not) 6) If you must, you can use hyperterm with the capture command and "Transfer>SendTextFile" but you ***ABSOLUTELY MUST FIRST SET "Send line ends with line feeds" PRIOR TO TRANSMITTING THE FILE*** My tests show that using capture at the oasis prompt with this setting off, causes hyperterm to strip the lf in your cfg file. Then the file on the controller appears as all on one line when typed back. 7) Motocross "send binary file" works from either the picodos or OASIS> capture command (as long as you obey rule #1) In all cases, its "Comm Settings > "Send LF after CR" was un-checked. 8a) Hyperterm works ok from OASIS> prompt IF the "Send Line ends with Line Feeds" is TRUE. (but you may later want to reset it to false so you don't get "Double OASIS> prompts" 8b) Hyperterm works ok from picodos C:\> prompt IF the "Send Line ends with Line Feeds" is FALSE. (also will work ok if TRUE but then you get the double prompt symptom. *************************** THE BOTTOM LINE(S) ***************************** USE dumb editors, check line endings with XVI32 to verify Rule#1 and xfer to a temp file (Rule#2) using MOTOCROSS !!!! (Or only if brave or hardwired to console port, you can use yr from picodos) **************************************************************************** If your forced to deal with an oasis.cfg file that may not have correct line endings even though it looks ok in notepad.... and you have no hex editor to verify... (eg. When you upload the file per recommendations above, it still is all on one line) It seems in my quick testing that you can use notepad to add extra lines at every line and then re-upload...(you will have line endings in hex editor of 0D 0D 0A which still seems to be ok with OASIS>) Curious if anyone else has experiences that differ from above, it would be great to nail this down and cookbook it along with how to recover if you do screw things up...... -Rich If you mistakenly issue the "reset pico" command while connected to the radio port, you will loose contact... The only ways to get it back are to: 1)Bounce the power 2)Wait ~32 minutes for the hardware reset (plus the wait for the radio wakeup procedure) Fortunately in the next release of code (still in testing), Bob added a warning message with a Y/N to remind you your on the radio... (Thanks Bob!) And please correct my last.... re: picodos using yr (ymodem receive...) is from hyperterm (motocross doesn't support ymodem file xfers....) -Rich And from Paul: Another follow up to this thread... sorry for the overkill. We successfully transferred a new oasis.cfg file to 2010M1 via radio link on Tuesday afternoon. The file was edited with a hex editor to include the correct 0D 0A line terminators. There were places where there were two in a row (0D 0A 0D 0A) but in no cases were there multiple 0Ds before a single 0A as I've run across in some other oasis.cfg files that are floating around (0D 0D 0A). Once the file was edited and double checked, we transferred it according to Rich's procedure in #6 below and detailed here: -Establish link with mooring -At oasis prompt, type "capture [filename] <enter>" -Go to HyperTerm properties, 'settings' tab, click 'ascii setup' button, check 'Send line ends with line feeds' button -Go to HyperTerm Transfer menu, and select 'Send Text File...' -Select file to send and wait for file transfer -At oasis prompt, type "^D" to close capture on oasis -Go back to HyperTerm properties and uncheck 'Send line ends with line feeds' -Check file on can to make sure it looks right (at oasis prompt, type "type [filename]") -If all looks correct, rename files (oasis.cfg to [oasis.bk?] and [filename] to oasis.cfg) and reset mooring. -Sacrifice a small animal (or vegetable for the vegetarians) to the mooring gods And finally... -Blame Rich if it doesn't work for you Just wanted to document the successful file transfer over the radio. The mooring came back immediately, and everything appears to be working well. Paul P.s. In #1 below, Rich says that he strongly recommends checking the file in a hex editor. I think this should be an absolute requirement. From Paul again: A couple of notes regarding the oasis.cfg file issue from Wednesday's deployment: First off, we were NOT able to modify the config file with the new pCO2 constants before it was deployed... Attempts to transfer the new file to the controller on the buoy did not appear to work, and looked (for about ten minutes there) like it corrupted the entire oasis directory. Due to past issues of corrupting the oasis controller with bad oasis.cfg files, and the above scare that the oasis directory was destroyed while on the way out to deploy the buoy, I was unwilling to continue attempting to get a file across to the controller. So unfortunately the constants are not correct for the pCO2 that is on the buoy. Secondly, the config file needs to be in its deployment form at the time the oasis can is closed!! Because there are some idiosyncrasies with this file transfer, having it on the bench gives plenty of time to recover if there is an issue. As of a week before deployment, the entire systems should ideally be hands off, and this definitely needs to be the case for all software/firmware on the can. Further bench testing (Thanks Rich!!) has shown that we may have nailed down the problem with the file transfer, but until additional testing shows that we can reliably do this over the radio on the buoy, no changes should be made after the can is closed. Some pCO2 specific thoughts: I know it's been this way for a long time (forever?), but why are the pCO2 constants contained in the oasis.cfg file? This is the only instrument-specific information contained in the oasis.cfg file (other than driver info); what would we need to do to bring them out? Ideally we would have them on shore for post processing, but if they need to absolutely be on the buoy, can they be in a separate file (pCO2.cfg maybe)? Maybe have a line in the oasis.cfg that would point to the pCO2 config file? With this information no longer in the oasis.cfg file, there is not the same danger of hanging the entire buoy if the file becomes corrupt in the transfer. It will also allow us to change the pCO2 constants if the instrument ever needs to be swapped in the field. I'm sure this has been considered before... I've either forgotten the answer, or wasn't in on the discussion. Apologies if I'm digging up old info. Thanks, Paul And from Bob: On another note, if we can *ever* get up to speed with the most current checked-in code, (that is, if we can switch to the new radios and wire protocol), it's worth noting that this new code also has some line editing features. They've turned out to be extremely useful for the respirometers, which are based on Oasis and where the line editor commands originated. Allows you to add, delete, and comment-out lines in OASIS.CFG in situ, which greatly reduces the need for transferring files. -Bob |
| Document generated by Confluence on Feb 03, 2026 16:22 |